home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / sml_nj / sml-386 / readme < prev    next >
Text File  |  1993-08-16  |  5KB  |  129 lines
  1. This directory (dist/ml/sml-386) contains a port by Yngve Guttesen to
  2. the I386 running MS Windows/MSDOS 5.0.  It requires 16MB of memory and
  3. a very particular memory management configurnation that we cannot
  4. characterize (not knowing the mysteries of PC memory management).
  5. The I386 code generator has been incorporated in the main distribution
  6. (by Mark Leone) and runs under Unix (Mach and BSD386) on Intel hardware.
  7. everything you need.  We also keep the files
  8. individually uncompressed for partial retrieval.
  9.  
  10. REPORT:
  11. -------
  12.  
  13. Please note that the report, found in the report subdirectory, is 42 pages 
  14. long.  Please check to see that you get them all when you print the 
  15. postscript file.  The size of the postscript file is 694769 bytes.  If the 
  16. size is right and it doesn't print all the pages, you may have to modify 
  17. the header of the postscript file to adapt it to your system.  Some people 
  18. still have a problem printing the postscript file.  We therefore provide
  19. the Latex sources and the postscript files for the figures (in the
  20. report subdirectory) so that you can remake the postscript and print it.   
  21. Finally, if all else fails the tech report can be requested by sending 
  22. mail to schulman@sierra.Stanford.EDU.  The tech report number is 
  23. CSL-TR-92-526, dated June 1992.  The original tech
  24. report was number CSL-TR-91-469, but this is somewhat dated.  We will issue
  25. a new tech report when there are major changes to the suite (new applications,
  26. etc.).  However, the latest version of the report is always on-line.
  27.  
  28. MACROS:
  29. -------
  30.  
  31. In the macros directory, we provide macros and sample makefiles
  32. for three machines:
  33.  
  34. Encore Multimax (CMU Mach 2.5: C and Fortran)
  35. SGI 4D/240     (IRIX System V Release 3.3: C only) 
  36. Alliant FX/8    (Alliant Rev. 5.0: C and Fortran)
  37.  
  38. These macros work for us with the above operating systems.  Unfortunately,
  39. our limited resources prevent us from supporting them in any way or 
  40. even fielding questions about them.   If they don't work for you, please
  41. contact Argonne National Labs for a version that will.  An e-mail address 
  42. to try might be monitor-users-request@mcs.anl.gov. An excerpt from
  43. a message, received from Argonne, concerning getting the macros follows:
  44.  
  45. "The parmacs package is in the public domain.  Approximately 15 people at
  46. Argonne (or associated with Argonne or students) have worked on the parmacs
  47. package at one time or another.  The parmacs package is implemented via macros
  48. using the M4 macropreprocessor (standard on most Unix systems).  Current
  49. distribution of the software is somewhat ad hoc.  Most C versions can be
  50. obtained from netlib (send electronic mail to netlib@ornl.gov with the message
  51. send index from parmacs).  Fortran versions have been emailed directly or sent
  52. on tape.  The primary documentation for the parmacs package is the book
  53. ``Portable Programs for Parallel Processors'' by Lusk, et al, Holt, Rinehart,
  54. and Winston 1987."
  55.  
  56. The makefiles provided in the individual program directories specify
  57. a null macro set that will turn the parallel programs into sequential 
  58. ones.  Note that we do not have a null macro set for FORTRAN.
  59.  
  60. MAILING LIST:
  61. -------------
  62.  
  63. Please send a note to splash@mojave if you have copied over the programs,
  64. so that we can put you on a mailing list for update reports.
  65.  
  66. CHANGES:
  67. -------
  68.  
  69. June 5, 1991.  
  70. ------------
  71.     1. The NEWPROC and PAUSEDEC macros have been removed.
  72.     2. The file adv.U in mp3d has been updated to fix a boundary
  73.            condition.
  74.         3. The ocean program has been updated with a new initial guess
  75.            to the equation solver to improve its convergence.  A new 
  76.        parameter has been added to the solver routine, and the calls 
  77.        to it have correspondingly changed.
  78.  
  79. June 13, 1991.  
  80. -------------
  81.      1. For mp3d, Global->BC is now initialized to 0 in setup.U.
  82.      2. Next version of tech report complete.
  83.  
  84. July 31, 1991.
  85. -------------
  86.     1. Small update made to mp3d section of report. Concerns number
  87.        of time-steps run with simulator.
  88.         2. Water source code updated with comments to describe input
  89.        parmeters better.
  90.  
  91. Aug. 6, 1991.
  92. ------------
  93.     1. Bug in water fixed.  Some interactions were not being 
  94.            examined correctly and a barrier was missing.  Some other 
  95.        minor cleanup done in water.
  96.         2. A new version of pthor created.  It primarily improves 
  97.        cache mapping behaviour.  See README file in pthor 
  98.        directory.
  99.         3. Reference to paper on data locality and memory system 
  100.        performance in Ocean added.
  101.  
  102. Aug. 28, 1991
  103. -------------
  104.     1. Locking bug in mp3d fixed. Caused null pointer dereferencing
  105.        on some machines.
  106.  
  107. May 29, 1992
  108. ------------
  109.     1. New application (Barnes-Hut) added.
  110.     2. Report updated accordingly. Section 4.2 on general behavioral
  111.        characteristics cleaned up and enhanced somewhat.
  112.        Also, indication given of how to scale some of the 
  113.        scientific applications to run on larger machines.
  114.  
  115. July 24, 1992
  116. -------------
  117.  
  118.     1. Some bugs in water fixed:
  119.         a) determining when comp_last should be decremented
  120.                to compute interactions correctly in interf.U and
  121.            poteng.U fixed.
  122.         b) a race condition between initializing and accumulating
  123.            into gl->VIR removed.  A new variable called
  124.            gl->initialized introduced to do this.
  125.         c) the code will not crash if input variable NFMC is
  126.            set to 0 and the input displacement file LWI12 (not
  127.            needed in this case) not provided.
  128.  
  129.